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Foreword 

This Technical Specification (TS) has been produced by ETSI 3rd Generation Partnership Project (3GPP). 

The present document may refer to technical specifications or reports using their 3GPP identities, UMTS identities or 
GSM identities. These should be interpreted as being references to the corresponding ETSI deliverables. 

The cross reference between GSM, UMTS, 3GPP and ETSI identities can be found under 
http ://webapp . etsi.org/kev/queryform. asp . 
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Foreword 



id , 



This Technical Specification has been produced by the 3 Generation Partnership Project (3GPP). 

The contents of the present document are subject to continuing work within the TSG and may change following formal 
TSG approval. Should the TSG modify the contents of the present document, it will be re-released by the TSG with an 
identifying change of release date and an increase in version number as follows: 

Version x.y.z 

where: 

x the first digit: 

1 presented to TSG for information; 

2 presented to TSG for approval; 

3 or greater indicates TSG approved document under change control. 

y the second digit is incremented for all changes of substance, i.e. technical enhancements, corrections, 
updates, etc. 

z the third digit is incremented when editorial only changes have been incorporated in the document. 



Introduction 



rd , 



The present document is part of a TS-family covering the 3 Generation Partnership Project; Technical Specification 
Group Services and System Aspects; Telecommunication management; as identified below: 

32.3 1 1 : Generic Integration Reference Point (IRP) management; Requirements 

32.312: Generic Integration Reference Point (IRP) management; Information Service (IS) 

32.313: Generic Integration Reference Point (IRP) management; Common Object Request Broker 

Architecture (CORBA) Solution Set (SS) 

32.317: Generic Integration Reference Point (IRP) management; SOAP Solution Set (SS) 
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Scope 



The present document specifies the SOAP Solution Set for Generic IRP management whose capabilities are specified in 
Generic IRP management: Information Service (3GPP TS 32.312 [1]). 

This Solution Set specification is related to TS 32.312 V8.0.X. 



2 References 

The following documents contain provisions which, through reference in this text, constitute provisions of the present 
document. 

• References are either specific (identified by date of publication, edition number, version number, etc.) or 
non-specific. 

• For a specific reference, subsequent revisions do not apply. 

• For a non-specific reference, the latest version applies. In the case of a reference to a 3GPP document (including 
a GSM document), a non-specific reference implicitly refers to the latest version of that document in the same 
Release as the present document. 

[I] 3GPP TS 32.312: "Telecommunication management; Generic Integration Reference Point (IRP) 
management: Information Service (IS)". 

[2] 3GPP TS 32.31 1: "Telecommunication management; Generic Integration Reference Point (IRP) 

management; Requirements". 

[3] 3GPP TS 32.1 1 1-2: "Telecommunication management; Alarm Integration Reference Point (IRP); 

Information Service (IS)". 

[4] 3GPP TS 32.302: "Telecommunication management; Configuration Management (CM); 

Notification Integration Reference Point (IRP): Information Service (IS)". 

[5] W3C WSDL 1 . 1 specification ( http://www.w3.org/TR/2001/NOTE-wsdl-20010315) 

[6] Thompson, H.S., Beech, D., Maloney, M., Mendleshon, N., eds. (May 2002). "XML Schema 

Part 1: Structures," Recommendation, World Wide Web Consortium 
http://www.w3.org/TR/xmlschema-l/ 

[7] Biron, P.V., Malhotra, A., eds. (May 2002). "XML Schema Part 2: Datatypes," Recommendation, 

World Wide Web Consortium http://www.w3.org/TR/xmlschema-2/ 

[8] W3C SOAP 1 . 1 specification ( http://www.w3.org/TR/2000/NOTE-SOAP-20000508/) 

[9] RFC 2616 (June 1999): "Hypertext Transfer Protocol - HTTP/1 . 1 " 

[10] W3C WSDL 1 . 1 specification ( http://www.w3 .org/TR/200 l/NOTE-wsdl-200 1 03 1 5) 

[II] W3C SOAP 1 .2 specification ( http://www.w3.org/TR/soapl2-partl/) 



3 Definitions and abbreviations 

3.1 Definitions 

For the purposes of the present document, the terms and definitions given in 3GPP TS 32.312 [1] apply. 
IRP document version number string (or "IRPVersion"): See 3GPP TS 32.31 1 [2] subclause 3.1. 
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3.2 



Abbreviations 



For the purposes of the present document, the following abbreviations apply: 

HTTP HyperText Transfer Protocol 

IRP Integration Reference Point 

IOC Information Object Class 

SS Solution Set 

WSDL Web Services Description Language 

XML extensible Markup Language 

WSDL Web Service Description Language 

WS-I Web Services Interoperability Organization 



4 Architectural Features 

The overall architectural feature of this IRP is specified in 3G TS 32.312 [1]. This clause specifies features that are 
specific to the SOAP SS. 

This clause specifies features that are specific to the SOAP SS. 

The SOAP 1.1 specification [8] and WSDL 1.1 specification [5] are supported. 

The SOAP 1.2 specification [11] is optionally supported. 

This specification uses "document" style in the WSDL description. 

This specification uses "literal" encoding style in the WSDL description. 

This specification uses a number of namespace prefixes throughout that are listed in Table 4.1. 

Table 4.1 : Prefixes and Namespaces used in this specification 



Prefix 


Namespace 


http 


http://schemas.xmlsoap.org/wsdl/http/ 


soap 


http://schemas.xmlsoap.org/wsdl/soap/ 


SOAP-ENV 


http://schemas.xmlsoap.org/soap/envelope/ 


SOAP-ENC or 
soapenc 


http://schemas.xmlsoap.org/soap/encoding/ 


xs or xsd 


http://www.w3.org/2001/XMLSchema 


xsi 


http://www.w3.org/2001/XMLSchema-instance 


genericlRPData 


http://www.3gpp.org/ftp/Specs/archive/32 series/3231 7/schema/3231 7-81 0/GenericlRPData 
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5 Mapping 

5.1 Operation mapping 

Generic IRP management: IS [1] defines semantics of operation visible across the Itf-N. Table 5.1 indicates mapping of 
these operations to their equivalents defined in this SS. 

Table 5.1 : Mapping from IS Notification/Operation to SS equivalents 



IS Operation TS 32.312 [1] 


SS Operation 


Qualifier 


getlRPVersion 


getlRPVersion 


M 


getOperationProfile 


getOperationProfile 





getNotificationProfile 


getNotificationProfile 






5.2 Operation parameter mapping 
5.2.1 Operation getlRPVersion 
5.2.1 .1 Input parameters 

None. 

Here is the XML schema fragment of the getlRPVersion request: 



<!-- getlRPVersion Request --> 
<element name="getIRPVersion"> 
</element> 



5.2.1.2 Output parameters 

Table 5.2.1.2: Mapping from IS getlRPVersion output parameters to SS equivalents 



IS Operation parameter 


SS Operation parameter 


Qualifier 


versionNumberSet 


genericlRPData:VersionNumberSetType versionNumberSet 


M 


status 


genericlRPData:getlRPVersionFault 


M 



Here is the XML schema fragment of the getlRPVersion response: 

<!-- getlRPVersion Response --> 
<element name="getIRPVersionResponse" > 
< c omp 1 exTyp e > 
<sequence> 

< element name= "versionNumberSet" type=" generic IRPDat a: VersionNumberSet Type "/> 
</sequence> 
</complexType> 
</element> 

5.2.1.3 Fault definition 

<!-- getlRPVersion Fault --> 
< element name="getIRPVersionFault"> 
<complexType> 
<choice> 

<element name="getIRPVersionFault" type="string" def ault="getIRPVersionFault"/> 
</choice> 
</complexType> 
</element> 
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5.2.2 Operation getOperationProfile 

5.2.2.1 Input parameters 

Table 5.2.2.1 : Mapping from IS getOperationProfile input parameters to SS equivalents 



IS Operation parameter 


SS Operation parameter 


Qualifier 


iRPVersion 


genericlRPData:VersionNumberType iRPVersion 


M 



Here is the XML schema fragment of the getOperationProfile request: 

<!-- getOperationProfile Request --> 
<element name="getOperationProf ile" > 
< c omp 1 exTyp e > 
<sequence> 

< element name=" iRPVersion" type="genericIRPData : VersionNumberType"/> 
</sequence> 
</complexType> 
</element> 

5.2.2.2 Output parameters 

Table 5.2.2.2: Mapping from IS getOperationProfile output parameters to SS equivalents 



IS Operation parameter 


SS Operation parameter 


Qualifier 


operationNameProfile,operationParameterProfile 


genericlRPData:OperationSetType operationSet 


M 


status 


genericlRPData:getOperationProfileFault 


M 



Here is the XML schema fragment of the getOperationProfile response: 

<!-- getOperationProfile Response --> 
<element name="getOperationProf ileResponse" > 

< c omp 1 exTyp e > 

<sequence> 

< element name=" operationSet" type="genericIRPData :OperationSetType"/> 
</sequence> 
</complexType> 
</element> 

5.2.2.3 Fault definition 

<!-- getOperationProfile Fault --> 

<element name="getOperationProf ileFault" > 

< c omp 1 exTyp e > 

<choice> 

<element name="getOperationProf ileFault" type=" string" /> 
< element ref ="genericIRPData :OperationNotSupportedFault"/> 
< element ref ="genericIRPData : InvalidParameterFault"/> 
</choice> 
</complexType> 
</element> 



5.2.3 Operation getNotificationProfile 

5.2.3.1 Input parameters 

Table 5.2.3.1 : Mapping from IS getNotificationProfile input parameters to SS equivalents 



IS Operation parameter 


SS Operation parameter 


Qualifier 


iRPVersion 


genericlRPData:VersionNumberType iRPVersion 


M 



Here is the XML schema fragment of the getNotificationProfile request: 
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<!-- getNotif icationProf ile Request --> 
< e lement name = " getNot i f icat ionProf i le " > 
<complexType> 
<sequence> 

< element name="iRPVersion" type="genericIRPData : VersionNumberType"/> 
</sequence> 
</complexType> 
</element> 

5.2.3.2 Output parameters 

Table 5.2.3.2: Mapping from IS getNotificationProfile output parameters to SS equivalents 



IS Operation parameter 


SS Operation parameter 


Qualifier 


notificationNameProfile,notificationParameterProfile 


genericlRPData:Notif icationSetType notificationSet 


M 


Status 


genericlRPData:getNotificationProfileFault 


M 



Here is the XML schema fragment of the getNotificationProfile response: 

<!-- getNotificationProfile Response --> 
<element name="getNotif icationProf ileResponse" > 
< c omp 1 exTyp e > 
<sequence> 

< element name="notif icationSet"type="genericIRPData : Not if icationSetType"/> 
</sequence> 
</complexType> 
</element> 



5.2.3.3 



Fault definition 



<!-- getNotificationProfile Fault --> 
<element name="getNotif icationProf ileFault" > 
< c omp 1 exTyp e > 
<choice> 

<element name="getNotif icationProf ileFault" type="string" 
default=" getNot if icationProf ileFault" /> 

< element ref ="genericIRPData :OperationNotSupportedFault"/> 
< element ref =" generic IRPDat a : InvalidParameterFault"/> 
</choice> 
</complexType> 
</element> 
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Annex A (normative): 
WSDL specifications 



<?xml version="l . 0" encoding="UTF-8" ?> 
<def initions xmlns="http : //schemas .xmlsoap .org/wsdl/" 
xmlns : soap="http : //schemas .xmlsoap .org/wsdl /soap/" 

xmlns :genericIRPSystem="http : //www. 3gpp . org/ ftp/Specs /archive/3 2_series/3 2 . 317/schema/32317- 
810/GenericIRPSystem" 

xmlns :xs="http: //www.w3 . org/2 001/XMLSchema" 

xmlns :genericIRPData="http : //www. 3gpp . org/f tp/Specs/archive/32_series/32 . 3 17/ schema/323 17- 
810/GenericIRPData" 

targetNamespace="http : //www. 3gpp .org/f tp/Specs/archive/32_series/32 . 3 17/ schema/ 32 317- 
810/GenericIRPSystem" > 
<types> 

< schema targe tNamespace="http : //www. 3gpp .org/f tp/Specs/archive/32_series/32 . 3 17/ schema/ 32 317 - 
810/GenericIRPData" xmlns="http: //www.w3 . org/2 1/XMLSchema " > 

<element name="OperationNotSupportedFault " type="string"/> 
<element name="InvalidParameterFault " type="string"/> 
<simpleType name="VersionNumberType"> 

<restriction base="string"/> 
</simpleType> 

<complexType name="VersionNumberSetType"> 
<sequence> 

<element name="versionNumber" type="genericIRPData: VersionNumberType" 
maxOccur s= " unbounded " / > 
</sequence> 
</complexType> 

<complexType name= " ParameterSetType " > 
<sequence> 

<element name="parameterName" type="string" maxOccurs="unbounded"/> 
</sequence> 
</complexType> 

<complexType name="OperationType"> 
<sequence> 

<element name= " operat ionName " type=" string" /> 

<element name=" parameter Set" type="genericIRPData: ParameterSetType "/> 
</sequence> 
</complexType> 

<complexType name=" Operat ionSe t Type "> 
<sequence> 

<element name=" operat ion" type="genericIRPDat a: Operat ionType" 
maxOccur s= "unbounded" /> 
</sequence> 
</complexType> 

< complexType name= " Not i f i cat ionType " > 
<sequence> 

<element name="notif icationName" type="string"/> 

<element name=" parameter Set" type="genericIRPData: ParameterSetType "/> 
</sequence> 
</ complexType > 

<complexType name="Notif icationSetType"> 
<sequence> 

<element name= "notification" type= "genericIRPData: Not if icat ionType" 
maxOccurs= "unbounded" /> 
</sequence> 
</ complexType > 

<!-- getlRPVersion Request --> 
<element name="getIRPVersion"/> 
<!-- getlRPVersion Response --> 
<element name="getIRPVersionResponse"> 
< c omp 1 exTyp e > 
<sequence> 

< element name="versionNumberSet" type=" genericIRPData : VersionNumberSetType"/> 
</sequence> 
< /complexType > 
</element> 

<!-- getlRPVersion Fault --> 
<element name="getIRPVersionFault"> 
< complexType > 
<choice> 

<element name="getIRPVersionFault" type="string"/> 
</choice> 
< /complexType > 
</element> 
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<!-- getOperationProf ile Request --> 
<element name= "getOperationProf ile" > 
<complexType> 
<sequence> 

< element name="iRPVersion" type="genericIRPData:VersionNumberType"/> 
</sequence> 
</complexType> 
</element> 

<!-- getOperationProf ile Response --> 
<element name=" getOperationProf ileResponse"> 
< c omp 1 exTyp e > 
<sequence> 

< element name=" operationSet" type="genericIRPData :OperationSetType" /> 
</sequence> 
</complexType> 
</element> 

<!-- getOperationProf ile Fault --> 
<element name=" getOperationProf ileFault "> 
< c omp 1 exTyp e > 
<choice> 

<element name="getOperationProf ileFault" type="string"/> 
< element ref ="genericIRPData :OperationNotSupportedFault"/> 
< element ref ="genericIRPData : InvalidParameterFault"/> 
</choice> 
</complexType> 
</element> 

<!-- getNotif icationProf ile Request --> 
<element name=" getNotif icationProf ile" > 
<complexType> 
<sequence> 

< element name = " iRPVersion " type="genericIRPData: VersionNumberType"/> 
</sequence> 
</complexType> 
</element> 

<!-- getNotif icationProf ile Response --> 
<element name= "getNot if icationProf ileResponse"> 
< c omp 1 exTyp e > 
<sequence> 
<element name="notif icationSet " type="genericIRPData:Notif icationSetType"/> 
</sequence> 

</complexType> 
</element> 

<!-- getNotif icationProf ile Fault --> 
<element name=" getNot if icationProf ileFault "> 
<complexType> 
<choice> 

<element name =" getNot if icationProf ileFault" type="string"/> 
< element ref ="genericIRPData :OperationNotSupportedFault"/> 
< element ref ="genericIRPData : InvalidParameterFault"/> 
</choice> 
</complexType> 
</element> 
</schema> 
</types> 
<message name="getIRPVersionRequest"> 

<part name= "parameter" element="genericIRPData : get IRPVersion" /> 
</message> 
<message name="getIRPVersionResponse"> 

<part name= "parameter" element="genericIRPData :getIRPVersionResponse"/> 
</message> 
<message name="getIRPVersionFault"> 

<part name = "parameter" element =" generic IRPDat a :getIRPVersionFault"/> 
</message> 
<message name=" getOperationProf ileRequest "> 

<part name = "parameter" element=" generic IRPDat a : getOperationProf ile"/> 
</message> 
<message name=" getOperationProf ileResponse"> 

<part name= "parameter" element =" generic IRPDat a : getOperationProf ileResponse"/> 
</message> 
<message name= "getOperationProf ileFault "> 

<part name= "parameter" element =" generic IRPDat a : getOperationProf ileFault "/> 
</message> 
<message name=" getNot if icationProf ileRequest "> 

<part name = "parameter" element=" generic IRPDat a : getNot if icationProf ile" /> 
</message> 
<message name= "getNotif icationProf ileResponse"> 

<part name=" parameter" element=" generic IRPDat a : getNot if icationProf ileResponse"/> 
</message> 
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<message name="getNotif icationProf ileFault"> 

<part name = "parameter" element =" generic IRPDat a : getNot if icationProf ileFault"/> 
</message> 

<portType name="GenericIRPPortType"> 
<operation name="getIRPVersion" > 

< input message="genericIRPSystem:getIRPVersionRequest "/> 
<output message="genericIRPSystem:getIRPVersionResponse"/> 

< fault name="getIRPVersionFault " message="genericIRPSystem:getIRPVersionFault "/> 
</operation> 
<operation name="getOperationProf ile"> 

< input message="genericIRPSystem:getOperationProf ileRequest "/> 
<output message="genericIRPSystem:getOperationProf ileResponse"/> 
< fault name="getOperationProf ileFault " 
message="genericIRPSystem:getOperationProf ileFault"/> 
</operation> 
<operation name =" getNot if icationProf ile" > 

< input message="genericIRPSys tern: getNot if icationProf ileRequest "/> 
<output message= "genericIRPSystem: getNot if icationProf ileResponse"/> 
< fault name=" getNot if icationProf ileFault " 
me s sage =" genericIRPSystem: getNot if icationProf ileFault "/> 
</operation> 
</portType> 
<binding name="GenericIRPBinding" type="genericIRPSystem:GenericIRPPortType"> 

<soap : binding style=" document" transport="http : //schemas .xmlsoap .org/soap/http"/> 
<operation name="getIRPVersion" > 
<soap : operation 
soapAction="http : //www. 3gpp . org/ ftp/Specs /archive/3 2_series/3 2 . 3 7#getIRPVersion" style= "document "/> 
< input > 

<soap:body use="literal"/> 
</ input > 
<output> 

<soap:body use="literal"/> 
</output> 
< fault name="getIRPVersionFault "> 

<soap:fault name="getIRPVersionFault" use="literal"/> 
</fault> 
</operation> 

<operation name="getOperationProf ile"> 
<soap : operation 
soapAction="http : //www. 3gpp . org/f tp/Specs/archive/32_series/32 . 3 7#getOperationProf ile" 
style= " document " / > 
< input > 

<soap:body use="literal"/> 
</ input > 
<output> 

<soap:body use="literal"/> 
</output> 
< fault name="getOperationProf ileFault "> 

<soap:fault name="getOperationProf ileFault" use="literal"/> 
</fault> 
</operation> 

<operation name =" getNot if icationProf ile" > 
<soap : operation 
soapAction="http : //www. 3gpp .org/f tp/Specs/archive/32_series/32 . 3 7#getNotif icationProf ile" 
style= " document " / > 
< input > 

<soap:body use="literal"/> 
</ input > 
<output> 

<soap:body use="literal"/> 
</output> 
< fault name=" getNot if icationProf ileFault "> 

<soap : fault name =" getNot if icationProf ileFault" use=" literal" /> 
</fault> 
</operation> 
</binding> 
</def initions> 
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Annex B (informative): 

Generic IRP WSDL/XML schema electronic files 

The electronic files corresponding to the normative WSDL/XML schema defined in the present document are available 
in native form in the following archive: 

http://www.3gpp.org/ftp/Specs/archive/32_series/323 17/schema/323 17-8 10-wsdl.zip 
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Annex C (informative): 
Change history 



Change history 


Date 


TSG# 


TSG Doc. 


CR 


R 


Subject/Comment 


Cat 


Old 


New 


Sep 2006 


SA 33 


SP-060555 


-- 


-- 


Submitted to TSG SA #33 for Information 


-- 


-- 


1.0.0 


Dec 2006 


SA_34 


SP-060741 


-- 


-- 


Submitted to TSG SA #34 for Approval 


-- 


2.0.0 


7.0.0 


Mar 2007 










Delete reference to the 32.314 CMIP SS. Reason: SA#35 endorsed 
the SA5 decision to not propagate the CMIP Solution Sets to Rel-7 
(TS 32.3x4, TS 32.4x4, TS 32.6x4) 




7.0.0 


7.0.1 


Jun 2007 


— 


— 


— 


— 


Changed TS Title. Reason: SOAP does not stand anymore for "Simple 
Object Access Protocol" 


— 


7.0.1 


7.0.2 


Dec 2008 


SA_42 


SP-080845 


0001 


— 


Incorrect URI specified in TS 32.317 (both word document and 
corresponding wsdl file) 


F 


7.0.2 


7.1.0 


Dec 2008 


SA 42 


-- 


-- 


-- 


Upgrade to Release 8 


-- 


7.1.0 


8.0.0 


Mar 2009 


SA_43 


SP-090207 


0002 


-- 


Include portType and binding in the WSDL 


C 


8.0.0 


8.1.0 
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